Skip to content

Conversation

@bjorntore
Copy link
Contributor

@bjorntore bjorntore commented Jul 4, 2025

Related app-lib PR: Altinn/app-lib-dotnet#745

Summary by CodeRabbit

  • Documentation
    • Added new guides on business processes and system tasks in Altinn apps, including configuration and use of standard system tasks like PDF generation and eFormidling.
    • Introduced detailed instructions for creating custom system tasks and configuring access control.
    • Updated metadata and improved titles/descriptions for process-related documentation to enhance clarity and navigation.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jul 4, 2025

Walkthrough

Several new documentation files were added to Altinn Studio, focusing on the concepts of business processes, process tasks, and system tasks (service tasks) including guides for implementing and configuring them, with examples for PDF generation and eFormidling. Additionally, minor metadata updates were made to existing process-related documentation in Norwegian Bokmål and English.

Changes

File(s) Change Summary
Process Concept Documentation
content/altinn-studio/concepts/process/_index.nb.md
New documentation on the business process concept in Altinn apps, tasks, and references to further documentation.
System Tasks Overview and Intro
content/altinn-studio/guides/development/service-tasks/_index.nb.md,
.../service-tasks/intro.nb.md
New guides introducing system tasks, their configuration, and requirements in Altinn applications.
Custom System Task Implementation
content/altinn-studio/guides/development/service-tasks/custom/_index.nb.md
Guide for creating custom system tasks with C# implementation and BPMN/process integration, including access control.
Standard System Task Guides
content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md,
.../service-tasks/eformidling/_index.nb.md
Guides for integrating PDF generation and eFormidling as standard system tasks in Altinn app processes.
Process Reference Metadata Updates
content/altinn-studio/reference/process/_index.en.md,
.../process/_index.nb.md,
.../process/tasks/_index.nb.md
Metadata updates: title and description changes, including compound word corrections in Norwegian Bokmål docs.

Sequence Diagram(s)

sequenceDiagram
    participant Developer
    participant Altinn Studio Docs
    participant Altinn App
    participant BPMN Process Engine

    Developer->>Altinn Studio Docs: Reads about process and system tasks
    Developer->>Altinn App: Implements custom IServiceTask (optional)
    Developer->>BPMN Process Engine: Adds serviceTask node in process.bpmn
    BPMN Process Engine->>Altinn App: Executes service task (PDF, eFormidling, custom)
    Altinn App-->>BPMN Process Engine: Returns task result, advances process
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~7 minutes

Poem

📚
New docs appear with structured grace,
On tasks and flows that apps embrace.
PDFs and forms now clearly shown,
Custom steps you build and own.
Altinn’s process, step by step,
Guides in place—no need to fret!
🚀

Note

⚡️ Unit Test Generation is now available in beta!

Learn more here, or try it out under "Finishing Touches" below.


📜 Recent review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between aacec37 and a369df4.

⛔ Files ignored due to path filters (1)
  • content/altinn-studio/guides/development/service-tasks/example-service-task-process.png is excluded by !**/*.png
📒 Files selected for processing (9)
  • content/altinn-studio/concepts/process/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/custom/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/eformidling/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/intro.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md (1 hunks)
  • content/altinn-studio/reference/process/_index.en.md (1 hunks)
  • content/altinn-studio/reference/process/_index.nb.md (1 hunks)
  • content/altinn-studio/reference/process/tasks/_index.nb.md (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • content/altinn-studio/reference/process/tasks/_index.nb.md
🚧 Files skipped from review as they are similar to previous changes (8)
  • content/altinn-studio/reference/process/_index.en.md
  • content/altinn-studio/reference/process/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/intro.nb.md
  • content/altinn-studio/guides/development/service-tasks/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/custom/_index.nb.md
  • content/altinn-studio/concepts/process/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/eformidling/_index.nb.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Analyze (javascript-typescript)
  • GitHub Check: Analyze (python)
✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feat/service-tasks

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (9)
content/altinn-studio/reference/process/tasks/_index.nb.md (1)

2-3: Beskrivelsen trenger en handlingsform for å skille seg fra tittelen

Begge feltene gjentar de samme to ordene; vurder å gjøre beskrivelsen mer verb-orientert slik at den tydelig forklarer formålet med siden.

-title: Prosessoppgaver
-description: Definere prosessoppgaver
+title: Prosessoppgaver
+description: Slik definerer du prosessoppgaver
content/altinn-studio/reference/process/_index.en.md (1)

2-3: Polish the English description

More idiomatic wording makes the sentence read smoother.

-description: The application has a process that can be modified according to needs
+description: The application includes a process that can be tailored to specific needs
content/altinn-studio/guides/development/service-tasks/intro.nb.md (2)

9-9: Manglende verb i eksempellisten

-Eksempler på standard systemoppgaver PDF-generering og eFormidling.
+Eksempler på standard systemoppgaver er PDF-generering og eFormidling.

11-11: Pronomen- og ordvalg

-Tjenesteeiere kan implementere sine egne systemoppgaver og legge de som steg i appens prosess.
+Tjenesteeiere kan implementere egne systemoppgaver og legge dem inn som steg i appens prosess.
content/altinn-studio/guides/development/service-tasks/_index.nb.md (2)

2-2: Fjern overflødig mellomrom i tittelen

Det henger et ekstra blanktegn til slutt.

-title: Hvordan konfigurere systemoppgaver i din Altinn-app 
+title: Hvordan konfigurere systemoppgaver i din Altinn-app

5-5: Bruk flertall i taggen for konsistens

-tags: [systemoppgave, service task]
+tags: [systemoppgaver, service task]
content/altinn-studio/guides/development/service-tasks/eformidling/_index.nb.md (1)

7-11: Correct misspellings and clarify wording in intro & warning block

Several typos weaken the credibility of the guide:

  • eFormildingeFormidling
  • grenerellegenerelle
  • funksjonalitenenfunksjonaliteten
-En systemoppgave for å sende instansdata via eFormilding følger med appen som standard, og kan legges til som et steg i prosessen for å tas i bruk.
+En systemoppgave for å sende instansdata via eFormidling følger med appen som standard og kan legges til som et steg i prosessen for å tas i bruk.

-Tidligere lå ikke denne funksjonaliteten i en systemoppgave, men var bakt inn i den grenerelle koden for å endre prosesssteg. Dersom appen din ble satt opp før versjon 8.7, så bør du deaktivere funksjonalitenen som kjøres utenfor prosessdefinisjonen.
+Tidligere lå ikke denne funksjonaliteten i en systemoppgave, men var bakt inn i den generelle koden som håndterer prosesssteg. Dersom appen din ble satt opp før versjon 8.7, bør du deaktivere funksjonaliteten som kjøres utenfor prosessdefinisjonen.
content/altinn-studio/concepts/process/_index.nb.md (1)

18-20: Polish wording around upcoming breaking changes

The sentence is a bit clunky and mixes tenses. A more natural phrasing in Bokmål:

-Det er mulig å opprette sine egne prosessoppgaver, men det er sannsynlig at det kommer relativt store breaking changes på interfacet i neste major versjon (9.0).
+Det er mulig å opprette egne prosessoppgaver, men det er sannsynlig at interfacet vil endres betydelig (breaking changes) i neste hovedversjon (9.0).
content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md (1)

10-13: Fix repeated typos in warning block

Same misspellings as in the eFormidling guide:

-Tidligere lå ikke denne funksjonaliteten i en systemoppgave, men var bakt inn i den grenerelle koden for å endre prosesssteg. Dersom appen din ble satt opp før versjon 8.7, så bør du deaktivere funksjonalitenen som kjøres utenfor prosessdefinisjonen.
+Tidligere lå ikke denne funksjonaliteten i en systemoppgave, men var bakt inn i den generelle koden som håndterer prosesssteg. Dersom appen din ble satt opp før versjon 8.7, bør du deaktivere funksjonaliteten som kjøres utenfor prosessdefinisjonen.
📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fc58e73 and 7b4c35c.

⛔ Files ignored due to path filters (1)
  • content/altinn-studio/guides/development/service-tasks/example-service-task-process.png is excluded by !**/*.png
📒 Files selected for processing (9)
  • content/altinn-studio/concepts/process/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/custom/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/eformidling/_index.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/intro.nb.md (1 hunks)
  • content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md (1 hunks)
  • content/altinn-studio/reference/process/_index.en.md (1 hunks)
  • content/altinn-studio/reference/process/_index.nb.md (1 hunks)
  • content/altinn-studio/reference/process/tasks/_index.nb.md (1 hunks)
🧰 Additional context used
📓 Path-based instructions (2)
`**/*.nb.md`: Check for Norwegian Bokmål (nb-NO) grammar and spelling with extra care. Pay special attention to specialized terminology and Norwegian-specific words.

**/*.nb.md: Check for Norwegian Bokmål (nb-NO) grammar and spelling with extra care. Pay special attention to specialized terminology and Norwegian-specific words.

⚙️ Source: CodeRabbit Configuration File

List of files the instruction was applied to:

  • content/altinn-studio/reference/process/tasks/_index.nb.md
  • content/altinn-studio/reference/process/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/intro.nb.md
  • content/altinn-studio/guides/development/service-tasks/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/custom/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/eformidling/_index.nb.md
  • content/altinn-studio/concepts/process/_index.nb.md
`content/**/*`: Check for links, markdown formatting, headings, grammar, and spelling in multiple languages (en-US, nb-NO, nn-NO).

content/**/*: Check for links, markdown formatting, headings, grammar, and spelling in multiple languages (en-US, nb-NO, nn-NO).

⚙️ Source: CodeRabbit Configuration File

List of files the instruction was applied to:

  • content/altinn-studio/reference/process/tasks/_index.nb.md
  • content/altinn-studio/reference/process/_index.nb.md
  • content/altinn-studio/reference/process/_index.en.md
  • content/altinn-studio/guides/development/service-tasks/intro.nb.md
  • content/altinn-studio/guides/development/service-tasks/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/custom/_index.nb.md
  • content/altinn-studio/guides/development/service-tasks/eformidling/_index.nb.md
  • content/altinn-studio/concepts/process/_index.nb.md
🧠 Learnings (7)
📓 Common learnings
Learnt from: olemartinorg
PR: Altinn/altinn-studio-docs#2134
File: content/altinn-studio/reference/ux/components/Cards/_index.en.md:20-23
Timestamp: 2025-04-24T12:27:04.998Z
Learning: For the Altinn Studio Docs repository, component links in documentation (like ../image, ../audio, ../video) do not need to use PascalCase (../Image, ../Audio, ../Video) even if they differ from the actual directory case, as the platform likely handles case-insensitivity in path resolution.
Learnt from: mSunberg
PR: Altinn/altinn-studio-docs#0
File: :0-0
Timestamp: 2025-04-04T08:22:36.805Z
Learning: When reviewing Norwegian content (files with .nb.md or .nn.md extensions), carefully check for spelling and grammar issues, particularly watching for changes to specialized terminology like "Digitaliseringsrundskrivet" and Norwegian-specific words.
content/altinn-studio/reference/process/tasks/_index.nb.md (1)
Learnt from: mSunberg
PR: Altinn/altinn-studio-docs#0
File: :0-0
Timestamp: 2025-04-04T08:22:36.805Z
Learning: When reviewing Norwegian content (files with .nb.md or .nn.md extensions), carefully check for spelling and grammar issues, particularly watching for changes to specialized terminology like "Digitaliseringsrundskrivet" and Norwegian-specific words.
content/altinn-studio/reference/process/_index.nb.md (1)
Learnt from: mSunberg
PR: Altinn/altinn-studio-docs#0
File: :0-0
Timestamp: 2025-04-04T08:22:36.805Z
Learning: When reviewing Norwegian content (files with .nb.md or .nn.md extensions), carefully check for spelling and grammar issues, particularly watching for changes to specialized terminology like "Digitaliseringsrundskrivet" and Norwegian-specific words.
content/altinn-studio/guides/development/service-tasks/_index.nb.md (2)
Learnt from: olemartinorg
PR: Altinn/altinn-studio-docs#2134
File: content/altinn-studio/reference/ux/components/Cards/_index.en.md:20-23
Timestamp: 2025-04-24T12:27:04.998Z
Learning: For the Altinn Studio Docs repository, component links in documentation (like ../image, ../audio, ../video) do not need to use PascalCase (../Image, ../Audio, ../Video) even if they differ from the actual directory case, as the platform likely handles case-insensitivity in path resolution.
Learnt from: mSunberg
PR: Altinn/altinn-studio-docs#0
File: :0-0
Timestamp: 2025-04-04T08:22:36.805Z
Learning: When reviewing Norwegian content (files with .nb.md or .nn.md extensions), carefully check for spelling and grammar issues, particularly watching for changes to specialized terminology like "Digitaliseringsrundskrivet" and Norwegian-specific words.
content/altinn-studio/guides/development/service-tasks/pdf/_index.nb.md (1)
Learnt from: olemartinorg
PR: Altinn/altinn-studio-docs#2134
File: content/altinn-studio/reference/ux/components/Cards/_index.en.md:20-23
Timestamp: 2025-04-24T12:27:04.998Z
Learning: For the Altinn Studio Docs repository, component links in documentation (like ../image, ../audio, ../video) do not need to use PascalCase (../Image, ../Audio, ../Video) even if they differ from the actual directory case, as the platform likely handles case-insensitivity in path resolution.
content/altinn-studio/guides/development/service-tasks/eformidling/_index.nb.md (2)
Learnt from: olemartinorg
PR: Altinn/altinn-studio-docs#2134
File: content/altinn-studio/reference/ux/components/Cards/_index.en.md:20-23
Timestamp: 2025-04-24T12:27:04.998Z
Learning: For the Altinn Studio Docs repository, component links in documentation (like ../image, ../audio, ../video) do not need to use PascalCase (../Image, ../Audio, ../Video) even if they differ from the actual directory case, as the platform likely handles case-insensitivity in path resolution.
Learnt from: mSunberg
PR: Altinn/altinn-studio-docs#0
File: :0-0
Timestamp: 2025-04-04T08:22:36.805Z
Learning: When reviewing Norwegian content (files with .nb.md or .nn.md extensions), carefully check for spelling and grammar issues, particularly watching for changes to specialized terminology like "Digitaliseringsrundskrivet" and Norwegian-specific words.
content/altinn-studio/concepts/process/_index.nb.md (1)
Learnt from: olemartinorg
PR: Altinn/altinn-studio-docs#2134
File: content/altinn-studio/reference/ux/components/Cards/_index.en.md:20-23
Timestamp: 2025-04-24T12:27:04.998Z
Learning: For the Altinn Studio Docs repository, component links in documentation (like ../image, ../audio, ../video) do not need to use PascalCase (../Image, ../Audio, ../Video) even if they differ from the actual directory case, as the platform likely handles case-insensitivity in path resolution.
⏰ Context from checks skipped due to timeout of 90000ms (1)
  • GitHub Check: Analyze (javascript-typescript)
🔇 Additional comments (1)
content/altinn-studio/reference/process/_index.nb.md (1)

2-3: Metadata ser god ut – ingen videre kommentarer

Comment on lines +1 to +6
---
title: Egendefinert
tags: [altinn-apps, process, bpmn, task, service task, systemoppgave]
weight: 10
alias:
---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Front-matter key typo breaks Hugo aliases

The front-matter uses alias: instead of the expected aliases: array. Hugo will silently ignore this, so canonical/old URLs won’t redirect.

-alias: 
+aliases:
+# legg inn eventuelle gamle URL-stier her, f.eks.
+# - /nb/altinn-studio/guides/development/service-tasks/custom/
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
---
title: Egendefinert
tags: [altinn-apps, process, bpmn, task, service task, systemoppgave]
weight: 10
alias:
---
---
title: Egendefinert
tags: [altinn-apps, process, bpmn, task, service task, systemoppgave]
weight: 10
aliases:
# legg inn eventuelle gamle URL-stier her, f.eks.
# - /nb/altinn-studio/guides/development/service-tasks/custom/
---
🤖 Prompt for AI Agents
In content/altinn-studio/guides/development/service-tasks/custom/_index.nb.md at
lines 1 to 6, the front-matter key is incorrectly set as alias: instead of
aliases:. Change the key from alias: to aliases: and make sure it is an array,
even if it contains a single value, to ensure Hugo processes the aliases
correctly for URL redirection.

@bjorntore bjorntore force-pushed the feat/service-tasks branch from 346b145 to a369df4 Compare August 6, 2025 12:16
Copy link
Contributor

@martinothamar martinothamar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice ✅ should we also say that these features are only available in v8.7 preview

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants